
package com.lianxueda.drawing.config;


import io.swagger.v3.oas.models.Components;
import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import org.springdoc.core.configuration.SpringDocConfiguration;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.boot.autoconfigure.AutoConfigureBefore;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.List;
import java.util.stream.Collectors;

/**
 * OpenAPI 配置类，用于配置 Swagger 文档生成
 * @author 29264
 */
@Configuration
@AutoConfigureBefore(SpringDocConfiguration.class)
public class SpringDocConfig {

    /**
     * 定义 OpenAPI Bean
     *
     * @return OpenAPI 配置实例
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(info()) // 配置信息部分
                .externalDocs(externalDocs()) // 配置外部文档
                .components(components()) // 配置组件（如安全方案）
                .addSecurityItem(securityRequirement()); // 添加安全要求
    }

    /**
     * 配置 API 基本信息
     *
     * @return Info 配置实例
     */
    private Info info() {
        return new Info()
                .title("证书报考管理系统") // API 标题
                .version("1.0") // API 版本
                .description("少儿美育管理系统接口文档") // API 描述
                .license(new License()
                        .name("Apache 2.0") // 许可证名称
                        .url("https://www.apache.org/licenses/LICENSE-2.0.html")) // 许可证 URL
                .contact(new Contact()
                        .name("怀文武") // 联系人姓名
                        .url("https://localhost:8080/swagger-ui/index.html") // 联系人 URL
                        .email("2926487313@qq.com")) // 联系人邮箱
                .termsOfService(""); // 服务条款 URL
    }

    /**
     * 配置外部文档
     *
     * @return ExternalDocumentation 配置实例
     */
    private ExternalDocumentation externalDocs() {
        return new ExternalDocumentation()
                .description("职业技能考证管理系统Restful API接口文档") // 外部文档描述
                .url(""); // 外部文档 URL
    }

    /**
     * 配置组件，包括安全方案
     *
     * @return Components 配置实例
     */
    private Components components() {
        return new Components()
                .addSecuritySchemes("Bearer Authorization",
                        new SecurityScheme()
                                .name("Authorization") // 安全方案名称
                                .type(SecurityScheme.Type.HTTP) // 安全方案类型
                                .scheme("Bearer") // 安全方案模式
                                .bearerFormat("JWT") // Bearer 格式
                                .in(SecurityScheme.In.HEADER) // 安全方案位置
                );
    }

    /**
     * 配置安全要求
     *
     * @return SecurityRequirement 配置实例
     */
    private SecurityRequirement securityRequirement() {
        return new SecurityRequirement()
                .addList("Bearer Authorization"); // 添加安全要求
    }

    /**
     * 获取所有安全要求
     *
     * @param components 组件实例
     * @return 安全要求列表
     */
    private List<SecurityRequirement> security(Components components) {
        return components.getSecuritySchemes()
                .keySet()
                .stream()
                .map(k -> new SecurityRequirement().addList(k))
                .collect(Collectors.toList());
    }

    /**
     * 定义通用接口的 GroupedOpenApi Bean
     *
     * @return GroupedOpenApi 配置实例
     */
    @Bean
    public GroupedOpenApi publicApi() {
        return GroupedOpenApi.builder()
                .group("default") // 分组名
                .packagesToScan("com.lianxueda.drawing.controller") // 按指定的包路径匹配
                .build();
    }
}
